Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRTriggerHotSpot

You can use the QTVRTriggerHotSpot function to trigger a hot spot.

OSErr QTVRTriggerHotSpot (
                     QTVRInstance qtvr,
                     UInt32hotSpotID,
                     QTAtomContainernodeInfo,
                     QTAtomselectedAtom);
qtvr
An instance of a QuickTime VR movie.
hotSpotID
A hot spot ID.
nodeInfo
A node information atom container (obtained from a previous call to QTVRGetNodeInfo ). You can pass the value 0 in this parameter to have the QuickTime VR Manager determine the appropriate node information atom container.
selectedAtom
The atom of the hot spot to trigger. You can pass the value 0 in this parameter to have the QuickTime VR Manager determine the appropriate hot spot atom.
function result
A result code.

DESCRIPTION

The QTVRTriggerHotSpot function triggers the hot spot specified by the hotSpotID , nodeInfo , and selectedAtom parameters in the movie specified by the  qtvr parameter. You can use QTVRTriggerHotSpot to execute an application-defined hot spot or to trigger any hot spot without the user's having clicked the hot spot.

In QuickTime VR version 2.0, you can call QTVRTriggerHotSpot only for hot spots that link panoramic and object nodes. QTVRTriggerHotSpot performs no additional action for any other type of hot spot (unless you intercept this function).

The QTVRTriggerHotSpot function is called internally by the QuickTime VR Manager whenever a user clicks a hot spot. Your application should need to call it only in conjunction with intercept procedures. You can intercept calls to trigger your custom hot spots, which allows you to perform any custom actions you desire.

QTVRTriggerHotSpot does not change the cursor during hot spot triggering.

For undefined hot spots (that is, for hot spots that do not have an entry in the node information atom container's list of hot spots), the selectedAtom parameter should be set to 0.

SPECIAL CONSIDERATIONS

You can call QTVRTriggerHotSpot even on hot spots that are currently disabled.

SEE ALSO

Use QTVRInstallInterceptProc [link] to install an intercept procedure.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |